home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_guile.idb / usr / freeware / share / guile / 1.5.6 / ice-9 / poe.scm.z / poe.scm
Text File  |  2002-07-08  |  5KB  |  144 lines
  1. ;;; installed-scm-file
  2.  
  3. ;;;;     Copyright (C) 1996, 2001 Free Software Foundation, Inc.
  4. ;;;; 
  5. ;;;; This program is free software; you can redistribute it and/or modify
  6. ;;;; it under the terms of the GNU General Public License as published by
  7. ;;;; the Free Software Foundation; either version 2, or (at your option)
  8. ;;;; any later version.
  9. ;;;; 
  10. ;;;; This program is distributed in the hope that it will be useful,
  11. ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13. ;;;; GNU General Public License for more details.
  14. ;;;; 
  15. ;;;; You should have received a copy of the GNU General Public License
  16. ;;;; along with this software; see the file COPYING.  If not, write to
  17. ;;;; the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  18. ;;;; Boston, MA 02111-1307 USA
  19. ;;;;
  20. ;;;; As a special exception, the Free Software Foundation gives permission
  21. ;;;; for additional uses of the text contained in its release of GUILE.
  22. ;;;;
  23. ;;;; The exception is that, if you link the GUILE library with other files
  24. ;;;; to produce an executable, this does not by itself cause the
  25. ;;;; resulting executable to be covered by the GNU General Public License.
  26. ;;;; Your use of that executable is in no way restricted on account of
  27. ;;;; linking the GUILE library code into it.
  28. ;;;;
  29. ;;;; This exception does not however invalidate any other reasons why
  30. ;;;; the executable file might be covered by the GNU General Public License.
  31. ;;;;
  32. ;;;; This exception applies only to the code released by the
  33. ;;;; Free Software Foundation under the name GUILE.  If you copy
  34. ;;;; code from other Free Software Foundation releases into a copy of
  35. ;;;; GUILE, as the General Public License permits, the exception does
  36. ;;;; not apply to the code that you add in this way.  To avoid misleading
  37. ;;;; anyone as to the status of such modified files, you must delete
  38. ;;;; this exception notice from them.
  39. ;;;;
  40. ;;;; If you write modifications of your own for GUILE, it is your choice
  41. ;;;; whether to permit this exception to apply to your modifications.
  42. ;;;; If you do not wish that, delete this exception notice.
  43. ;;;; 
  44.  
  45.  
  46. (define-module  (ice-9 poe)
  47.   :use-module (ice-9 hcons)
  48.   :export (pure-funcq perfect-funcq))
  49.  
  50.  
  51.  
  52.  
  53. ;;; {Pure Functions}
  54. ;;; 
  55. ;;; A pure function (of some sort) is characterized by two equality
  56. ;;; relations: one on argument lists and one on return values.
  57. ;;; A pure function is one that when applied to equal arguments lists
  58. ;;; yields equal results.
  59. ;;;
  60. ;;; If the equality relationship on return values can be eq?, it may make
  61. ;;; sense to cache values returned by the function.  Choosing the right
  62. ;;; equality relation on arguments is tricky.
  63. ;;;
  64.  
  65.  
  66. ;;; {pure-funcq}
  67. ;;;
  68. ;;; The simplest case of pure functions are those in which results
  69. ;;; are only certainly eq? if all of the arguments are.  These functions
  70. ;;; are called "pure-funcq", for obvious reasons.
  71. ;;;
  72.  
  73.  
  74. (define funcq-memo (make-weak-key-hash-table 523)) ; !!! randomly selected values
  75. (define funcq-buffer (make-gc-buffer 256))
  76.  
  77. (define (funcq-hash arg-list n)
  78.   (let ((it (let loop ((x 0)
  79.                (arg-list arg-list))
  80.           (if (null? arg-list)
  81.           (modulo x n)
  82.           (loop (logior x (hashq (car arg-list) 4194303))
  83.             (cdr arg-list))))))
  84.     it))
  85.  
  86. (define (funcq-assoc arg-list alist)
  87.   (let ((it (and alist
  88.          (let and-map ((key arg-list)
  89.                    (entry (caar alist)))
  90.            (or (and (and (not key) (not entry))
  91.                 (car alist))
  92.                (and key entry
  93.                 (eq? (car key) (car entry))
  94.                 (and-map (cdr key) (cdr entry))))))))
  95.     it))
  96.  
  97.  
  98.  
  99. (define (pure-funcq base-func)
  100.   (lambda args
  101.     (let ((cached (hashx-get-handle funcq-hash funcq-assoc funcq-memo (cons base-func args))))
  102.       (if cached
  103.       (begin
  104.         (funcq-buffer (car cached))
  105.         (cdr cached))
  106.         
  107.       (let ((val (apply base-func args))
  108.         (key (cons base-func args)))
  109.         (funcq-buffer key)
  110.         (hashx-set! funcq-hash funcq-assoc funcq-memo key val)
  111.         val)))))
  112.  
  113.  
  114.  
  115. ;;; {Perfect funq}
  116. ;;;
  117. ;;; A pure funq may sometimes forget its past but a perfect
  118. ;;; funcq never does.
  119. ;;;
  120.  
  121. (define (perfect-funcq size base-func)
  122.   (define funcq-memo (make-hash-table size))
  123.  
  124.   (lambda args
  125.     (let ((cached (hashx-get-handle funcq-hash funcq-assoc funcq-memo (cons base-func args))))
  126.       (if cached
  127.       (begin
  128.         (funcq-buffer (car cached))
  129.         (cdr cached))
  130.         
  131.       (let ((val (apply base-func args))
  132.         (key (cons base-func args)))
  133.         (funcq-buffer key)
  134.         (hashx-set! funcq-hash funcq-assoc funcq-memo key val)
  135.         val)))))
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.